<code>
______________________________________________________________________
ontogenizar              package: nenhum               R Documentation
______________________________________________________________________

Pgina de ajuda da funo ontogenizar
Funo para a organizao e classificao de informao coletada e armazenada em diversos formatos de vdeo digital.

Description:
	
A funo ontogenizar  uma funo simples para a organizar informao de vdeo. Produz um dataframe (guardado em um output.txt) com os arquivos organizados cronologicamente, em dias, semanas, meses e anos. Tambm cria uma pasta, no diretrio indicado pelo usurio, com os arquivos organizados conforme o recorte temporal pr-definido por ele nos argumentos. 


Usage:

ontogenizar (in_fol="C:/Users/Fulano/Downloads/Macaco_fulano", out_fol= "C:/Users/Fulano/Downloads/Output", db= "2013-04-17", unit= "month", period= 3, subject= Ind_X")


Arguments:

in_fol	 	endereo da pasta contendo os arquivos a ser classificados

out_fol	 	endereo onde o output.txt e a pasta resultante sero criados

db 	 	data de nascimento (date_of_birth); vetor data. Data pela qual queira se-estabelecer  ordem dos arquivos, em formato YYYY-MM-DD. 

unit		recorte temporal desejado na ontogenizao dos dados (day, week, month, year)

period			fraco de unit pela que os arquivos sero classificados; vetor numrico inteiro. 

subject 	nome do sujeito; vetor carter. Se subject  NULL, utiliza-se por default subject= "Ind_X"


 
Details:

A funo foi criada para ser usada em sistema operacional Windows.
As pastas (in_fol e out_fol) devem ser caminhos vlidos, com o formato de barra de Windows (/).
Se o usurio quer classificar seus dados por vrios perodos, basta rodar a funo vrias vezes modificando os argumentos unit e period.
Se o usurio especifica valores de unit e period inexistentes na pasta de origem (in_fol) a funo criar uma pasta nomeada pelo recorte temporal, porm vazia.


Value:

comp1 : retorna um data.frame com as seguintes informaes: nome, nascimento, arquivos, lista.data, id.dia, id.sem, id.mes, id.ano. Esse df  copiado na pasta de sada (out_fol), determinada pelo usurio.

comp2 : gera uma pasta, classificada conforme a unidade (day, week, month ou year)escolhida pelo usurio.

     
Warning:

Se a pasta criada por unit e period (e.g. 8 month) escolhidos pelo usurio j existe, o sistema devolve uma mensagem automtica (e.g. Sofia 8 month already exists).

Aviso de argumento faltante para in_fol, out_fol, db, period e unit. Todos eles so argumentos obrigatrios. 

Caso argumento unit esteja mal escrito, o usurio ser avisado.

Caso o argumento period no seja um nmero entero, o usurio ser avisado.

Caso o argumento subject esteja faltando a funo usar por default Ind_X. Uma mensagem de aviso informar ao usurio.


Author(s):

Irene Delval 
irenedelval@usp.br


See Also:

difftime, Date, POSIXlt, POSIXct, seq


Examples:

#1# Baixar todos os arquivos de exemplo embaixo. Salve todos eles em um mesmo diretrio. Utilize o caminho para este diretrio no argumento in_fol dos exemplos 
e.g. ontogenizar(in_fol="C:/Users/Fulano/Downloads/Macaco_fulano"...)

#2# Escolha o local onde os arquivos sero "ontogenizados" e coloque o caminho a esse diretrio no argumento "out_fol".

#3# Escolha os valores dos argumentos obrigatrios db, unit, period. Por se tratar de um exemplo, tambm pode escolher o argumento "subject" que da sua preferncia, ou deixar o default. (Normalmente o usuario saber a identidade do indivduo a ontogenizar).

#4# Execute a funo e veja a pasta de sada e o data.frame criado (output.txt).

#5# Repita os passos 1-4 as vezes que achar necessrio, mudando os valores em unit e period.

##exemplo em meses:
ontogenizar (in_fol="C:/Users/Fulano/Downloads/Macaco_fulano", out_fol= "C:/Users/Fulano/Downloads/Output", db= "2013-04-17", unit= "month", period= 3, subject= "Irene")

##exemplo em semanas:
ontogenizar (in_fol="C:/Users/Fulano/Downloads/Macaco_fulano", out_fol= "C:/Users/Fulano/Downloads/Output", db= "2013-04-17", unit= "week", period= 1, subject= "Irene")

##exemplo em ano:
ontogenizar (in_fol="C:/Users/Fulano/Downloads/Macaco_fulano", out_fol= "C:/Users/Fulano/Downloads/Output", db= "2013-04-17", unit= "ano", period= 1, subject= "Irene")

## exemplo Ind default:
ontogenizar (in_fol="C:/Users/Fulano/Downloads/Macaco_fulano", out_fol= "C:/Users/Fulano/Downloads/Output", db= "2013-04-17", unit= "ano", period= 2)

______________________________________________________________________
